home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Tele / I-L / IDOD 3.4.1.CPT / IDOD 3.4.1 / IDOD Dox & Stuff / IDOD Quick Dox < prev    next >
Text File  |  1992-02-15  |  14KB  |  361 lines
  1.  
  2. I Dream Of Downloading 3.4
  3. Copyright © 1992
  4. Robert A. Daniel
  5. All Rights Reserved
  6.  
  7. 1156 W. 103rd St., Suite #150      <-- new address
  8. Kansas City, MO 64114
  9. (816) 943-1214
  10. ____________________________________________________________
  11.  
  12. FOR BEST RESULTS, VIEW THIS TEXT FILE IN MONACO OR A MONOSPACED FONT
  13.  
  14.  
  15. IDOD 3.4 will run only with White Knight and NOT Red Ryder.  IDOD 3.2
  16. is available in the FreeSoft libraries and may still work with Red Ryder
  17. but it is no longer supported.  Please upgrade to White Knight if you
  18. want to take all the advantages of IDOD.
  19.  
  20. A nicely formatted and more compete manual has been written for IDOD 3.3
  21. in Word and MacWrite which still applies for IDOD 3.4.  This documentation
  22. is very detailed and is worth downloading.
  23.  
  24. In the Mac library:
  25. 15306 IDOD 3.3/3.2 DOX-MCWRITE X B.DANIEL    
  26.       Desc: IDOD 3.3/3.2 Dox for MacWrite
  27. 15307 IDOD 3.3/3.2 DOX-MS WORD X B.DANIEL    
  28.       Desc: IDOD 3.3/3.2 Dox for MS Word 3.0 up
  29.  
  30. ____________________________________________________________
  31.  
  32. Requirements:
  33. White Knight 11.06 or newer
  34. Any text editor desk accessory (such as Sigma Edit, McSink, Vantage)
  35. Hard Drive recommended
  36.  
  37.  
  38. Overview:
  39. IDOD will download a batch of files from GEnie based on a list which is 
  40. created by you or by GEnie.  The procedure looks through the list until it 
  41. sees a flag character (default is the asterisk “*”) which you place in the 
  42. list.  The flag character is to be placed in front of the file NUMBER of each 
  43. file desired to download.  IDOD will download all of the files in the list that 
  44. contain the flag.  Registered users can have IDOD dial GEnie and 
  45. automatically log in and download completely unattended.  It can also dial at 
  46. a specified time.
  47.  
  48. IDOD has a Quick & Dirty (Q&D) feature to allow downloading up to 24 files 
  49. without having to edit or create a list with flag characters.  It is setup in a 
  50. single window.
  51.  
  52. A log is kept in a text file called " IDOD Log" which keeps track of the time 
  53. and cost to download each file and totals up at the end of the procedure.  All 
  54. errors are also recorded in the log.
  55.  
  56. When using the dialer, IDOD will check if you have mail.  If you do, it will 
  57. read your mail and append it to a file for later viewing.
  58.  
  59.  
  60.  
  61. Limitations to non-registered users:
  62.     
  63.     IDOD is completely functional except for the dialing feature.  If not 
  64. registered, IDOD will only work when you are online to GEnie.  See the order 
  65. form at end of this dox to register or initiate the "IDOD Order Form" 
  66. procedure located in the IDOD folder.  When registered, you will receive
  67. a password via GEnie Mail to activate the rest of IDOD.  
  68.  
  69. There is NO upgrade fee for registered users of previous versions.
  70.  
  71.  
  72. How to use IDOD:
  73.  
  74.     IDOD has two modes of operation:  Expert and Novice.  The novice mode 
  75. is intended for introductory use.  Primarily for those of you who have never 
  76. used it, the novice mode will walk you through the setup and explain the 
  77. process of preparing a list.  It is more time consuming to use but allows 
  78. easier understanding of the procedure.  When familiar with using IDOD, use 
  79. the expert mode.
  80.  
  81.     The expert mode is designed to have the least amount of prompts as 
  82. possible in order to reduce wasted time in IDOD.  Registered users have the 
  83. advantage of using the dialer, therefore they can be off-line when preparing 
  84. to download.
  85.  
  86. Starting up IDOD:
  87.  
  88. •    Initiate the procedure under the “Service” menu.  
  89.  
  90. •    The first time IDOD is run, it will ask what folder IDOD is located in.  
  91. Enter the folder that contains IDOD, then click on "Select".  You will not need 
  92. to do this anymore once it has been defined.
  93.  
  94.  
  95.  
  96. Downloading:
  97.  
  98.     IDOD will search the list for the flag characters and download the 
  99. marked files.  If the file does not exist, IDOD will record the error and 
  100. continue to the next file.  This may occur if using an old list that may 
  101. contain files no longer in existence or if the numbers were not defined 
  102. correctly.
  103.  
  104.  
  105. Example list:
  106. (This list was created by GEnie and captured by IDOD to a file called " GENIE 
  107. LIST".)
  108.  
  109.  8679 APFONT 3.0.SIT           X J.HAMILTON10 880310   17640    149   5
  110.       Desc: cdev to change default font
  111.  *8690 AREALITYBBS              X M.SHAWE      880311    2520      1  10
  112.       Desc: announcing new BBS
  113.  ?8695 CAT DOS & DON'TS.SIT     X G.HOPKINS    880312   36540      5  11
  114.       Desc: Humorous advice for cats
  115.  *8693 DOCTER V1.70 - SIT       X MSWALL       880311   39060     14   6
  116.       Desc: Makes stand alone docs w/graphics!!
  117.  8667 EAGLE/BORDER.SIT         X T.TEDDER     880310   13860     30   1
  118.  
  119. The flag must be placed directly in front of the file NUMBER!  There must not 
  120. be a space between the file number and the flag.
  121.  
  122. The procedure will download only files 8690 and 8693 and will get a longer
  123. description of 8695.  When the end of the list is reached, the procedure 
  124. will end.  The list may be as long as you like!
  125.  
  126.  
  127. Q&D Downloading:
  128.             
  129.     If you do not want to download files based on a list, you don't have to.  
  130. The Q&D option will allow you to enter up to 24 file numbers to download.  
  131. You may do this for online use or prepare it before entering GEnie via the 
  132. dialer.  (Remember that you must register in order to use the dialer.)
  133.  
  134.  
  135. Multi-Page Downloading:
  136.  
  137.     Multi-Page Downloading refers to downloading from more than one RT 
  138. (which are referenced as pages).  The list that contains the files to 
  139. download should be divided into pages and have the following above each RT 
  140. list: "-->###" where ### is the page number of the file section that 
  141. corresponds to the listing below.  See sample Multi-Page list in the same 
  142. folder as this version of IDOD.  
  143.  
  144.  
  145. Getting More Description of a file:
  146.  
  147.     If you want more information on a file, place a '?' in front of the file
  148. number instead of a flag character.  This will get a long description of
  149. the file and will place it in the file "GEnie Long List" in the same folder
  150. as IDOD.
  151.  
  152.  
  153. Other Stuff:
  154.  
  155.     The Black Status Bar shows the process of the procedure as it is 
  156. searching and downloading.  The file number and name of the current file 
  157. downloading is shown.  It also notifies you when the end of the list has been 
  158. reached.
  159.     
  160.     Every action of IDOD is recorded in a log called " IDOD Log" which is 
  161. placed in the same folder as IDOD.  The log keeps track of the time taken to 
  162. download each file and estimates your cost.
  163.  
  164.     I considered every possible error I could find.  This procedure is 
  165. meant to be used unattended so I tried to consider every possible error in 
  166. order for it to continue without attention.  If you come up with an error that 
  167. IDOD can’t detect, please let me know.  I don’t guarantee that it can detect 
  168. all errors but I covered all that I could find.  
  169.  
  170.  
  171. Error Checking:
  172.  
  173. •  If the flag is part of a file name.  Example: (* is defined as the flag)
  174.  
  175.   729 BCS*CLICKER2             X KENWINOGRAD  880131    3780     30   8
  176.       Desc: Clicker...mouse coordinate DA (handy
  177.  
  178. IDOD will attempt to download a file by the number “CLICKER2” but GEnie 
  179. will give an error.  IDOD will detect that error, record it, and continue with 
  180. the next file.
  181.  
  182. •  If a download has started and you decide to cancel it, click on the close 
  183. window box during the download.  GEnie will respond that you have cancelled 
  184. the transfer, IDOD will detect it, and continue with the next file.  The cancel 
  185. will be recorded in the log.
  186.  
  187. •  If an old list is used where the file number no longer exists,  GEnie will 
  188. prompt an error which is then detected by IDOD.  The error will be recorded. 
  189.  
  190. •  If you use the wrong password or id in the dial window, GEnie will 
  191. respond with a validation or fault error.  IDOD will automatically hang up 
  192. and pop up a window stating that the password or id is incorrect in the Dial 
  193. window.
  194.  
  195.  
  196. •  IDOD is very thorough in panic traps.  If for some reason IDOD gets out of 
  197. sync with GEnie or an unexcpect prompt appears that causes IDOD to get 
  198. stuck, IDOD will perform an emergency logoff (after 2 minutes of no 
  199. responses).  The emergency logoff will be recorded in the log. 
  200.  
  201.  
  202. The recorded errors will be displayed after the procedure has completed to 
  203. alert you which files where not downloaded.  You also have a choice to 
  204. immediately print the log file for the most recent IDOD session.
  205.  
  206.  
  207. Hints:
  208.  
  209.     The procedure looks for at least two pipes ‘||’ at the end of the file 
  210. which tells it to quit.  If the listing is rather long, place a few pipes on its 
  211. own line after the last file to download.  This will speed up the procedure 
  212. because it will not have to search through the remainder of the list. 
  213.  
  214.     Another way to speed it up is to remove any file names or 
  215. unnecessary lines not being used.  The procedure looks at every line in the 
  216. file until it comes up to a flag or two pipes.  The less lines, the faster the 
  217. procedure.  This is not necessary, but searching will be slightly faster 
  218. especially if on a floppy drive.
  219.  
  220.     If you want some files that are not on the list, just insert the file 
  221. number(s) at the top of the listing and insert the flag character in front of 
  222. each number.  It is not necessary to provide the file name or description.  
  223. Each additional file number must be on its own line.
  224.  
  225.  
  226.  
  227. Using the long description file supplied by GEnie:
  228.     The long description file that is occasionally updated by GEnie can be 
  229. used as a list to download from.  Place the flag character directly in front 
  230. of the file number to download.  To speed up the procedure, place a few 
  231. pipes (||) on a line of its own after the LAST file you want to download.  This 
  232. is faster because it will not have to search through the rest of the list.  I 
  233. don't think you should use this list unless you have like a 25Mhz accelerator 
  234. card and a really fast hard drive.  I just want it be known that IDOD does 
  235. support the long description file.
  236.  
  237.  
  238. ____________________________________________________________
  239.  
  240. ZMODEM Downloading:
  241.  
  242. There are two ways to use ZMODEM: One file at a time or true batch 
  243. downloading.  Downloading one file at a time means that as file is 
  244. individually scanned and then individually downloaded (the way IDOD has 
  245. always done it). True batch downloading means that IDOD will prescan the
  246. list and build batches of 20 files to download all at once.  If a list 
  247. contains 35 files to download, IDOD will build a batch of 20 and a second 
  248. batch of 15.  There are three drawbacks to the TRUE Batch method. 
  249.  
  250. 1) If you cancel the batch download, then you have cancel the entire batch. If 
  251. you do a File-by-File download (the first method) you can individually 
  252. cancel a download.
  253.  
  254. 2) If one (or more) of the files you select to download doesn't exist on
  255. GEnie, the entire batch will NOT be downloaded. This is a problem with
  256. GEnie and I will write a letter to see if they can fix it.
  257.  
  258. 3) If one (or more) of the files is uploaded in 7 bit text, GEnie won't
  259. send it.
  260.  
  261. None of this is at fault of IDOD or WK.  The first problem is just the
  262. nature of ZMODEM batches.  The second two are problems with GEnie.  If
  263. you do heavy overnight batch downloading, I suggest you use the file by
  264. file method (one file at a time).
  265.  
  266.  
  267. Because the prescan (a seperate procedure written with the help of an
  268. RCMD) can only be done when dialing into GEnie, a list can not be 
  269. prescanned while online. The true batch method requires prescanning
  270. therefore can only be done when dialing into GEnie.  This will be
  271. expanded to use online in a future version. The bottom line is that if
  272. you want to do true batch downloading, you must be a registered user.
  273.  
  274. ____________________________________________________________
  275.  
  276. Setting up File-by-File and True Batch:
  277.  
  278. In the "Options" there are four methods of downloading: XMODEM, XMODEM 1K, 
  279. ZMODEM, and ZMODEM Batch.
  280.  
  281. If you select "ZMODEM", IDOD will download one file at a time using the
  282. ZMODEM protocol.  If you select "ZMODEM Batch", IDOD will scan the list
  283. and build sets of 20 files per batch. If you are online and attempt to
  284. use "ZMODEM Batch", IDOD will automatically use the File-By-File method.
  285.  
  286. In the "Dial" window, there is an option to Prescan the list before dialing.
  287. With XMODEM or ZMODEM, you have the option to scan the list before dialing.
  288. This will find all the file to download before dialing therefore there isn't
  289. any wasted time while online when searching for a file.  If you are using
  290. "ZMODEM Batch", you MUST prescan the list so that the sets of 20 files
  291. per batch can be made.  This may be a little confusing, but try out the
  292. two methods to see how they work.  I'll attempt to make this easier in
  293. a future version.
  294.  
  295. Whether doing XMODEM, ZMODEM, or "ZMODEM Batch", you should prescan the
  296. list to reduce wasted time online.
  297.  
  298.  
  299. ____________________________________________________________
  300.  
  301.  
  302. All registered users will receive the password to enable the complete 
  303. version (which will work in any roundtable and will dial) and be eligible to  
  304. ßeta test any future procedures.  Please provide your GEnie Mail address so 
  305. that I can mail the password to you.  
  306.  
  307. I Dream Of Downloading 3.4
  308. Written & © '91 by Robert A. Daniel
  309. All Rights Reserved
  310. GEnie mail: BOB.DANIEL
  311. AT&T Mail: attmail!cikpc!bob
  312. USENET: rad@genco.bungi.com
  313.  
  314. Robert A. Daniel
  315. 1156 W. 103rd St., Suite #150  
  316. Kansas City, MO 64114
  317. (816) 942-5226
  318. (913) 451-0851
  319.  
  320.  
  321. ____________________________________________________________
  322.  
  323. Order form - Send $15 to:
  324.  
  325.  
  326. Robert A. Daniel
  327. 1156 W. 103rd St., Suite #150  
  328. Kansas City, MO 64114
  329. (816) 942-5226
  330. (913) 451-0851
  331.  
  332.   
  333.               Name:   _____________________________________________
  334.            Company:    _____________________________________________
  335.            Address:    _____________________________________________
  336.                        _____________________________________________
  337.            Phone #:    _____________________________________________
  338.   GEnie Mail Name:    _____________________________________________
  339.  
  340.  
  341.  
  342. Approximate number of files downloaded per MONTH: 
  343.  
  344. __ Under 5     __ 5 - 15     __ 15 - 25     __ Over 25
  345.  
  346.             
  347. What features would you like to see in future versions (It may 
  348. involve any feature on GEnie, not just downloading)?
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356. Comments:
  357.  
  358.  
  359.  
  360.  
  361.